package com.danciyixue.boot.dcyx.service;

import com.danciyixue.boot.dcyx.model.entity.DailyTimeRecords;
import com.danciyixue.boot.dcyx.model.form.DailyTimeRecordsForm;
import com.danciyixue.boot.dcyx.model.query.DailyTimeRecordsQuery;
import com.danciyixue.boot.dcyx.model.vo.DailyTimeRecordsVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 用户每日时间记录服务类
 *
 * @author youlaitech
 * @since 2025-06-28 10:26
 */
public interface DailyTimeRecordsService extends IService<DailyTimeRecords> {

    /**
     *用户每日时间记录分页列表
     *
     * @return {@link IPage<DailyTimeRecordsVO>} 用户每日时间记录分页列表
     */
    IPage<DailyTimeRecordsVO> getDailyTimeRecordsPage(DailyTimeRecordsQuery queryParams);

    /**
     * 获取用户每日时间记录表单数据
     *
     * @param id 用户每日时间记录ID
     * @return 用户每日时间记录表单数据
     */
     DailyTimeRecordsForm getDailyTimeRecordsFormData(Long id);

    /**
     * 新增用户每日时间记录
     *
     * @param formData 用户每日时间记录表单对象
     * @return 是否新增成功
     */
    boolean saveDailyTimeRecords(DailyTimeRecordsForm formData);

    /**
     * 修改用户每日时间记录
     *
     * @param id   用户每日时间记录ID
     * @param formData 用户每日时间记录表单对象
     * @return 是否修改成功
     */
    boolean updateDailyTimeRecords(Long id, DailyTimeRecordsForm formData);

    /**
     * 删除用户每日时间记录
     *
     * @param ids 用户每日时间记录ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteDailyTimeRecordss(String ids);

    /**
     * 获取或创建今日在线时长记录
     *
     * @return 今日在线时长记录
     */
    DailyTimeRecordsVO getOrCreateTodayOnlineSeconds();

    /**
     * 增加今日在线时长
     *
     * @param formData 在线时长表单数据
     * @return 是否更新成功
     */
    boolean addTodayOnlineSeconds(DailyTimeRecordsForm formData);
}
